home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung 2 / Power-Programmierung CD 2 (Tewi)(1994).iso / tools / exe2bin / exe2com / exe2com.doc < prev    next >
Encoding:
Text File  |  1987-11-22  |  5.8 KB  |  168 lines
  1.                                   EXE2COM 1.02
  2.                          By Chris Dunford/Cove Software
  3.  
  4.  
  5.         Purpose
  6.         -------
  7.         EXE2COM is a one-for-one replacement for the EXE2BIN program
  8.         that was formerly distributed with DOS.  Beginning with DOS 3.3,
  9.         EXE2BIN has been moved to the disk that comes with the DOS
  10.         Technical Reference and thus is not available without extra
  11.         cost.
  12.  
  13.  
  14.         Usage
  15.         -----
  16.         Usage is identical to DOS's EXE2BIN except that the output file
  17.         extension defaults to COM rather than BIN (when was the last
  18.         time you saw a BIN file?).
  19.  
  20.         Complete usage is:
  21.  
  22.             EXE2COM [d:][path]file[ext] [d:][path][file][ext]
  23.  
  24.         The drive and path of the first file default to the current
  25.         drive and path, if not specified.  The extension of the first
  26.         file defaults to EXE, if not specified.
  27.  
  28.         If the second file is completely unspecified, it defaults to the
  29.         same drive, path, and filename as the first, except that the
  30.         extension will be COM.
  31.  
  32.         If the second file is specified but without an extension, COM
  33.         will be assumed (this is different from EXE2BIN).
  34.  
  35.         The simplest (and usual) usage is simply:
  36.  
  37.             EXE2COM file
  38.  
  39.         which will take the named EXE file in the current directory and
  40.         convert it to a COM file in the same directory.
  41.  
  42.  
  43.         Operation
  44.         ---------
  45.         EXE2COM runs the same way as EXE2BIN, with the following
  46.         exceptions:
  47.  
  48.             1. The binary fixup option of EXE2BIN (IP=0, segment fixups
  49.             required) is not supported.
  50.  
  51.             2. The EXE file checksum is not verified.
  52.  
  53.             3. Error messages are more useful, and a warning is provided
  54.             if a COM file is created with an initial IP other than 100H.
  55.  
  56.  
  57.         Error Messages
  58.         --------------
  59.         These are EXE2COM's error messages.  If one of these is seen,
  60.         the EXE file will not be converted and the errorlevel returned
  61.         by EXE2COM will be 1.
  62.  
  63.         ERROR READING EXE HEADER
  64.             EXE2COM was unable to read the EXE file header from disk.
  65.  
  66.         ERROR WRITING OUTPUT FILE
  67.             EXE2COM was unable to write the converted file to disk.
  68.  
  69.         INVALID EXE FILE SIGNATURE
  70.             The first two bytes of an EXE file should be ASCII 'M' and
  71.             'Z'.  This was not the case, and it's probably not an EXE
  72.             file.
  73.  
  74.         EXE HAS RELOCATABLE ITEMS
  75.             In order to be converted to a COM file, an EXE file cannot
  76.             have any direct references to segments.  For example, the
  77.             assembler instruction "mov ax,code" (where CODE is a segment
  78.             name) is a segment reference.  One or more segment
  79.             references were found in the EXE file.
  80.  
  81.         EXE HAS STACK SEGMENT
  82.             In order to be converted to a COM file, an EXE file cannot
  83.             have a stack segment.
  84.  
  85.         EXE HAS NONZERO CS
  86.             In order to be converted to a COM file, an EXE file must
  87.             have a code segment that begins at offset 0 of the code
  88.             image in the EXE file.
  89.  
  90.         IP NOT 0 OR 100H
  91.             In order to be converted to a binary file, an EXE file must
  92.             have an entry point of 0 or 100H within the code segment.
  93.             For COM files, the entry point should be 100H.  For SYS
  94.             files (device drivers), the entry point should be 0.
  95.  
  96.         PROGRAM EXCEEDS 64K
  97.             In order to be converted to a binary file, the total size of
  98.             the code to be loaded (including the PSP) must not exceed
  99.             64K bytes.
  100.  
  101.         UNKNOWN ERROR
  102.             Internal error.  Notify the author.
  103.  
  104.  
  105.         Warning message
  106.         ---------------
  107.         EXE2COM has one warning message:
  108.  
  109.             COM FILE, INITIAL IP NOT 100H
  110.  
  111.         The entry point of all COM files should be 100H.  If you are
  112.         creating a COM file an the entry point is not 100H, EXE2COM will
  113.         do the job but let you know that there is a potential problem.
  114.  
  115.  
  116.         Source
  117.         ------
  118.         Source code should be included with this archive.  Users are
  119.         encouraged to modify, improve, and/or correct the source for
  120.         EXE2COM and submit the new program to the author for
  121.         distribution.  Please identify clearly any changes made.
  122.  
  123.         Source for EXE2COM is currently available for the Computer
  124.         Innovations C86 compiler (EXE2COM.C86) and for Borland's Turbo C
  125.         (EXE2COM.TC).  The C86 version in particular should be easily
  126.         portable to other compilers.
  127.  
  128.         For compilation, the desired source should of course be renamed
  129.         to EXE2COM.C.
  130.  
  131.         The executable in this archive (EXE2COM.EXE) is from the C86
  132.         source.  The executable derived from the Turbo C source is
  133.         available from Borland International's forum on CompuServe.
  134.  
  135.  
  136.         Public domain
  137.         -------------
  138.         EXE2COM is hereby donated by the author to the public domain.
  139.  
  140.  
  141.         History
  142.         -------
  143.         Version 1.00 04/17/87: Original version by
  144.  
  145.             Christopher J. Dunford
  146.             The Cove Software Group
  147.             PO Box 1072
  148.             Columbia, MD 21044
  149.             (301) 992-9371
  150.             CompuServe 76703,2002
  151.  
  152.         Version 1.01: port to Turbo C by
  153.  
  154.             Roger Schlafly
  155.             Borland International
  156.             Scotts Valley, CA 95066
  157.             CompuServe 76067,511
  158.  
  159.         Version 1.02 11/22/87: bug fix for even 512-byte file made to
  160.         Turbo C port by
  161.  
  162.             Chris Blum ( Consultant )
  163.             509 West Main, Front
  164.             Ashland, Ohio 44805
  165.             CompuServe 76625,1041
  166.  
  167.             Chris Dunford duplicated the fix in the C86 source.
  168.